MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

Jump to SDK endpoint

GET /openmlbb/academy/meta/version GET /openmlbb/academy/heroes/catalog GET /openmlbb/academy/roles GET /openmlbb/academy/equipment GET /openmlbb/academy/equipment/expanded GET /openmlbb/academy/spells GET /openmlbb/academy/emblems GET /openmlbb/academy/ranks GET /openmlbb/academy/ranks/{rank_id} GET /openmlbb/academy/recommended GET /openmlbb/academy/recommended/{recommended_id} GET /openmlbb/academy/heroes GET /openmlbb/academy/heroes/{hero_identifier}/stats GET /openmlbb/academy/heroes/{hero_identifier}/lane GET /openmlbb/academy/heroes/{hero_identifier}/win-rate/timeline GET /openmlbb/academy/heroes/{hero_identifier}/builds GET /openmlbb/academy/heroes/{hero_identifier}/counters GET /openmlbb/academy/heroes/{hero_identifier}/teammates GET /openmlbb/academy/heroes/{hero_identifier}/trends GET /openmlbb/academy/heroes/{hero_identifier}/recommended GET /openmlbb/academy/heroes/ratings GET /openmlbb/academy/heroes/ratings/{subject}

GET Recommended Detail

/openmlbb/academy/recommended/{recommended_id}

Open Only This

API Path: /api/academy/recommended/{recommended_id}

Get details for a specific recommended content item by its identifier. Supports query parameters for pagination and localization.

Path parameters:

  • recommended_id: Identifier for the recommended post (minimum: 1).

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes detailed recommended content data:

  • records: Array of recommended entries, each containing:
      • createdAt: Creation timestamp.
      • updatedAt: Last update timestamp.
      • data:
          • channels: Content channels (e.g., 'UGC', 'recommend').
          • type: Content type (e.g., 'ugc_hero').
          • state: Content state (e.g., 'release').
          • data:
              • hero: Hero metadata including:
                  • hero_id: Hero ID.
                  • hero_lane: Lane assignment.
                  • hero_overview: Overview description.
                  • hero_strength: Strengths.
                  • hero_weakness: Weaknesses.
                  • hero_tags: Array of tag IDs.
              • equips: Recommended equipment builds with IDs and descriptions.
              • emblems: Recommended emblem sets with IDs and descriptions.
              • spell: Recommended battle spell with ID and description.
              • cooperates: Cooperative hero synergies with descriptions and rates.
              • counters: Counter heroes with descriptions and rates.
              • dominants: Dominant strategies or tips.
              • recommend: General recommendation notes.
              • snapshot: Snapshot image URL.
              • game_version: Version reference.
              • language: Content language.
              • pages: Content sections (e.g., 'hero', 'spell', 'equip').
              • title: Guide or build title.
          • user: Author metadata including:
              • name: Author name.
              • avatar: Author avatar URL.
              • level: Author level.
              • roleId: Role ID.
              • zoneId: Zone ID.
          • dynamic: Engagement metrics:
              • views: Total views.
              • votes: Total votes.
              • hot: Hotness score.
              • views_by_4h_total_24h: Views in last 24h.
          • vote_all: Voting metadata:
              • average: Average rating.
              • count: Vote count.
              • total: Total votes.
              • user_count: Number of users voted.
              • vote: Vote ID reference.

This endpoint is useful for:

  • Displaying full details of a single guide or build.
  • Explaining strategic recommendations.
  • Surfacing community-generated content for MLBB players.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.recommended_by_id(1, size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
recommended_id path integer yes -
size query integer no 20
index query integer no 1
lang query string no en